doc updates.

diff --git a/ChangeLog b/ChangeLog
index d97a748890317bb8400eaff011deadafa2ede324..4ce893501bb7d741a1739b586e9818cbcf7a1308 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+Fri Mar  5 23:52:34 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+       Improve the docs.  (#127727, Murray Cumming)
+
 Fri Mar  5 23:37:16 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index d97a748890317bb8400eaff011deadafa2ede324..4ce893501bb7d741a1739b586e9818cbcf7a1308 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,8 @@
+Fri Mar  5 23:52:34 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+       Improve the docs.  (#127727, Murray Cumming)
+
 Fri Mar  5 23:37:16 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the

diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4
index d97a748890317bb8400eaff011deadafa2ede324..4ce893501bb7d741a1739b586e9818cbcf7a1308 100644 (file)
--- a/ChangeLog.pre-2-4
+++ b/ChangeLog.pre-2-4
@@ -1,3 +1,8 @@
+Fri Mar  5 23:52:34 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+       Improve the docs.  (#127727, Murray Cumming)
+
 Fri Mar  5 23:37:16 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the

diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index d97a748890317bb8400eaff011deadafa2ede324..4ce893501bb7d741a1739b586e9818cbcf7a1308 100644 (file)
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,8 @@
+Fri Mar  5 23:52:34 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+       Improve the docs.  (#127727, Murray Cumming)
+
 Fri Mar  5 23:37:16 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the

diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index d97a748890317bb8400eaff011deadafa2ede324..4ce893501bb7d741a1739b586e9818cbcf7a1308 100644 (file)
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,8 @@
+Fri Mar  5 23:52:34 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/gtktreemodelfilter.c (gtk_tree_model_filter_set_modify_func): 
+       Improve the docs.  (#127727, Murray Cumming)
+
 Fri Mar  5 23:37:16 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtktreeview.c (gtk_tree_view_set_reorderable): Clarify the

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 9991658823c0db54e7330a796704bc05abd03f69..67fcdfbe14ed70f68c9f443b7358a86bc4041d27 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,7 @@
+Fri Mar  5 23:58:01 2004  Matthias Clasen  <maclas@gmx.de>
+
+       * gtk/tmpl/gtktreemodelfilter.sgml: A little addition.
+
 Fri Mar  5 23:45:06 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/tmpl/gtkinvisible.sgml: Remove "internally-used"

diff --git a/docs/reference/gtk/tmpl/gtktreemodelfilter.sgml b/docs/reference/gtk/tmpl/gtktreemodelfilter.sgml
index adceb079502b9547f731c6f4d5eaee796a92bf35..62ad1b0ebad4c7e758f6c4dc4778c220ec238fa3 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktreemodelfilter.sgml
+++ b/docs/reference/gtk/tmpl/gtktreemodelfilter.sgml
@@ -67,6 +67,10 @@ A function which calculates display values from raw values in the model.
 It must fill @value with the display value for the column @column in the 
 row indicated by @iter. 
 </para>
+<para>
+Since this function is called for each data access, it's not a
+particularly efficient operation.
+</para>
 
 @model: the #GtkTreeModelFilter
 @iter: a #GtkTreeIter pointing to the row whose display values are determined

diff --git a/gtk/gtktreemodelfilter.c b/gtk/gtktreemodelfilter.c
index b6934c90b0396b39411bbabf3ba20548c70eb242..fc250c0d2726ba4c0d3e50a6aec73b1157cbf648 100644 (file)
--- a/gtk/gtktreemodelfilter.c
+++ b/gtk/gtktreemodelfilter.c
@@ -2489,8 +2489,13 @@ gtk_tree_model_filter_set_visible_func (GtkTreeModelFilter            *filter,
  * @data: User data to pass to the modify function, or %NULL.
  * @destroy: Destroy notifier of @data, or %NULL.
  *
- * Sets the @filter to have @n_columns columns with @types and sets 
- * @func to be the modify function of @filter.
+ * With the @n_columns and @types parameters, you give an array of column
+ * types for this model (which will be exposed to the parent model/view).
+ * The @func, @data and @destroy parameters are for specifying the modify
+ * function. The modify function will get called for <emphasis>each</emphasis>
+ * data access, the goal of the modify function is to return the data which 
+ * should be displayed at the location specified using the parameters of the 
+ * modify function.
  *
  * Since: 2.4
  */